AngularJS's source includes code to generate documentation from their source code as well as from files that contain strictly documentation and no code. Docular follows the original approach and provides ways to extend the documentation API. The best way to learn is to install the grunt-docular on an existing project and follow the information here to start generating your own docs.
Leveraging AngularJS's approach gives you the power to create flexible documentation using the latest in dev technology
The DDO ( Docular Documentation Object ) can be thought of as an object that is created by parsing out common properties in your documentation, transforming them into an object, and then generating a viewable Partial by running the DDO through the Docular rendering process.
Visualizing your documentation turning into a DDO object and then being used to generate HTML is important. Continue through this guide and learn how this basic understanding becomes very powerful when you introduce extendible transformations that modify the DDO's during the creation and partial generation process.
Most examples will use the default "Doc" API for generating documentation, however we will also introduce example from the "ngdoc" API which is the API that parses and renders AngularJS's documentation within Docular.
Your next step is to understand the workflow from start to finish. This is covered in the "From Docs to Partials" step. Enjoy!